Azure Maps Feature State Service (preview:2.0)

2025/08/14 • 8 deleted methods

FeatureState_CreateStateset (removed)
Description **Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier). Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator. This POST API allows the user to create a new Stateset and define stateset style using request body. Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. The Feature State API is part of Creator. The Feature State service allows the user to update the states of a feature and query them to be used in other services. The dynamic properties of a feature that don't belong to the dataset are referred to as *states* here. This Feature State service pivot on the Stateset. Like Tileset, Stateset encapsulates the storage mechanism for feature states for a dataset. Once the stateset is created, users can use that statesetId to post feature state updates and retrieve the current feature states. A feature can have only one state at a given point in time. Feature state is defined by the key name, value and the timestamp. When a feature state update is posted to Azure Maps, the state value gets updated only if the provided state’s timestamp is later than the stored timestamp. Azure Maps MapControl provides a way to use these feature states to style the features. Please refer to the [State Tile documentation](https://docs.microsoft.com/en-us/rest/api/maps/render/get-map-state-tile-preview) for more information.
Reference Link ¶

⚼ Request

POST:  /featureStateSets
{
subscription-key: string ,
api-version: string ,
datasetId: string ,
description: string ,
statesetCreateRequestBody:
{
styles:
[
object ,
]
,
}
,
}

⚐ Response (200)

{
statesetId: string ,
}

⚐ Response (400)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (401)

{
$headers:
{
www-authenticate: string ,
}
,
$schema:
{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
,
}

⚐ Response (403)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (404)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (500)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
FeatureState_ListStateset (removed)
Description **Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier). Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator. This API allows the caller to fetch a list of all previously successfully created statesets.
Reference Link ¶

⚼ Request

GET:  /featureStateSets
{
subscription-key: string ,
api-version: string ,
}

⚐ Response (200)

{
statesets:
[
{
statesetId: string ,
description: string ,
datasetIds:
[
string ,
]
,
statesetStyle:
{
styles:
[
object ,
]
,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (400)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (401)

{
$headers:
{
www-authenticate: string ,
}
,
$schema:
{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
,
}

⚐ Response (403)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (404)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (500)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
FeatureState_PutStateset (removed)
Description **Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier). Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator. This PUT API allows the user to update the stateset style rules.
Reference Link ¶

⚼ Request

PUT:  /featureStateSets/{statesetId}
{
subscription-key: string ,
api-version: string ,
statesetId: string ,
statesetStyleUpdateRequestBody:
{
styles:
[
object ,
]
,
}
,
}

⚐ Response (200)

{}

⚐ Response (400)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (401)

{
$headers:
{
www-authenticate: string ,
}
,
$schema:
{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
,
}

⚐ Response (403)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (404)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (500)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
FeatureState_DeleteStateset (removed)
Description **Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier). Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator. This DELETE API allows the user to delete the stateset and the associated data.
Reference Link ¶

⚼ Request

DELETE:  /featureStateSets/{statesetId}
{
subscription-key: string ,
api-version: string ,
statesetId: string ,
}

⚐ Response (204)

{}

⚐ Response (400)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (401)

{
$headers:
{
www-authenticate: string ,
}
,
$schema:
{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
,
}

⚐ Response (403)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (404)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (500)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
FeatureState_GetStateset (removed)
Description **Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier). Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator. This GET API allows the user to get the stateset Information. The stateset Information includes the datasetId associated to the stateset, and the styles of that stateset.
Reference Link ¶

⚼ Request

GET:  /featureStateSets/{statesetId}
{
subscription-key: string ,
api-version: string ,
statesetId: string ,
}

⚐ Response (200)

{
description: string ,
datasetIds:
[
string ,
]
,
statesetStyle:
{
styles:
[
object ,
]
,
}
,
}

⚐ Response (400)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (401)

{
$headers:
{
www-authenticate: string ,
}
,
$schema:
{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
,
}

⚐ Response (403)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (404)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (500)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
FeatureState_UpdateStates (removed)
Description **Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier). Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator. This PUT API allows the user to update the state of the given feature in the given stateset.
Reference Link ¶

⚼ Request

PUT:  /featureStateSets/{statesetId}/featureStates/{featureId}
{
subscription-key: string ,
api-version: string ,
statesetId: string ,
featureId: string ,
featureStateUpdateRequestBody:
{
states:
[
{
keyName: string ,
value: object ,
eventTimestamp: string ,
}
,
]
,
}
,
}

⚐ Response (200)

{}

⚐ Response (400)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (401)

{
$headers:
{
www-authenticate: string ,
}
,
$schema:
{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
,
}

⚐ Response (403)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (404)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (500)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
FeatureState_DeleteState (removed)
Description **Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier). Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator. This API deletes the state information identified by the StateKeyName parameter for the feature identified by the FeatureId parameter in the the stateset.
Reference Link ¶

⚼ Request

DELETE:  /featureStateSets/{statesetId}/featureStates/{featureId}
{
subscription-key: string ,
api-version: string ,
statesetId: string ,
featureId: string ,
stateKeyName: string ,
}

⚐ Response (204)

{}

⚐ Response (400)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (401)

{
$headers:
{
www-authenticate: string ,
}
,
$schema:
{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
,
}

⚐ Response (403)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (404)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (409)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (500)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
FeatureState_GetStates (removed)
Description **Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier). Creator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator. This API returns the current state information associated with the given feature in the given stateset.
Reference Link ¶

⚼ Request

GET:  /featureStateSets/{statesetId}/featureStates/{featureId}
{
subscription-key: string ,
api-version: string ,
statesetId: string ,
featureId: string ,
}

⚐ Response (200)

{
states:
[
{
keyName: string ,
value: object ,
eventTimestamp: string ,
}
,
]
,
}

⚐ Response (400)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (401)

{
$headers:
{
www-authenticate: string ,
}
,
$schema:
{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}
,
}

⚐ Response (403)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (404)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}

⚐ Response (500)

{
error:
{
code: string ,
message: string ,
details:
[
string ,
]
,
target: string ,
}
,
}